BLOCK

Syntax: BLOCK [#channel,] width, height, x, y, colour   
Location: QL ROM

This command draws a block of size width x height at position  x,y of the given colour in the specified window (default #1). Both the position and the block size are given in absolute pixel co-ordinates, with the maximum ranges specified by the physical size of the window.

As with other graphics commands, the colour can be made up of up to three parameters, giving the background, contrast and stipple pattern (composite colours).

NOTE:
Some ROMs (not SMS) will allow you to specify blocks which lie partly outside of a window without reporting the error 'Out of Range'. However, this can also crash some ROMs!

Odd values for width and x are always rounded down to an even number (eg. 23 pixels wide becomes 22 pixels). This is to ensure compatibility between MODE 4 and MODE 8. The only problem is that you cannot specify a block one pixel wide, or even have a gap of one pixel between two blocks.

Unless you have a Minerva ROM or SMS, you cannot draw a block 512 pixels wide - you need to use two adjacent blocks instead!

CROSS-REFERENCE:
INK contains information concerning composite colours.
